refactor(deps): move zod to peerDependencies with v4-mini by ryoppippi · Pull Request #278 · StackOneHQ/stackone-ai-node

ryoppippi · 2026-01-05T16:38:04Z

Summary

Move zod from dependencies to peerDependencies (>=3.25.0 <5)
Use zod/v4-mini subpath for smaller bundle size in schema/headers
Use zod/v4 subpath in feedback.ts (requires .transform/.refine)
Add zod to devDependencies and examples for development/testing

Why

This allows users to bring their own zod version (3.25+ or 4.x) while ensuring compatibility with AI SDK's zod peer dependency. The zod/v4-mini variant reduces bundle size for simple schemas.

Test plan

All tests pass
Lint passes

pkg-pr-new · 2026-01-05T16:38:49Z

Open in StackBlitz

npm i https://pkg.pr.new/StackOneHQ/stackone-ai-node/@stackone/ai@278

commit: 11108bc

cubic-dev-ai

No issues found across 9 files

Copilot

Pull request overview

This PR attempts to refactor Zod dependency management by moving it from dependencies to peerDependencies and updating all imports to use a zod/v4 subpath. However, the implementation contains a critical issue: the zod/v4 import path does not exist in Zod's package exports.

Key changes attempted:

Move zod from dependencies to peerDependencies with version range >=3.25.0 <5
Add zod to devDependencies (^4.1.13) for development
Replace all zod imports with zod/v4 subpath (from zod/mini and zod)

Reviewed changes

Copilot reviewed 8 out of 9 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/schema.ts	Updates import from `zod/mini` to invalid `zod/v4` subpath
src/headers.ts	Updates import from `zod/mini` to invalid `zod/v4` subpath
src/feedback.ts	Updates import from `zod` to invalid `zod/v4` subpath
pnpm-workspace.yaml	Moves zod from prod catalog to dev catalog, adds peer catalog entry
pnpm-lock.yaml	Updates lock file to reflect catalog changes
package.json	Moves zod from dependencies to peerDependencies and devDependencies
examples/tanstack-ai-integration.ts	Updates import to invalid `zod/v4` subpath
examples/claude-agent-sdk-integration.ts	Updates import to invalid `zod/v4` subpath
examples/claude-agent-sdk-integration.test.ts	Updates import to invalid `zod/v4` subpath

Files not reviewed (1)

pnpm-lock.yaml: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-05T16:41:33Z

examples/claude-agent-sdk-integration.test.ts


 import { tool, createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
+import { z } from 'zod/v4';


The import path zod/v4 does not appear to be a valid subpath export in Zod's package. Zod (up to version 4.1.13) exports zod (main), zod/mini, and zod/locales/*, but not zod/v4. This import will likely cause a "Module not found" error at runtime.

The standard import should be import { z } from 'zod' for the main Zod API. If version 4-specific APIs are needed, they are available through the standard zod import when using Zod 4.x.

Suggested change

import { z } from 'zod/v4';

import { z } from 'zod';

Copilot · 2026-01-05T16:41:33Z

src/schema.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod/mini';
+import { z } from 'zod/v4';


The import path zod/v4 does not appear to be a valid subpath export in Zod's package. Zod (up to version 4.1.13) exports zod (main), zod/mini, and zod/locales/*, but not zod/v4. This import will likely cause a "Module not found" error at runtime.

The standard import should be import { z } from 'zod' for the main Zod API. If version 4-specific APIs are needed, they are available through the standard zod import when using Zod 4.x.

Suggested change

import { z } from 'zod/v4';

import { z } from 'zod';

Copilot · 2026-01-05T16:41:34Z

src/headers.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod/mini';
+import { z } from 'zod/v4';


The import path zod/v4 does not appear to be a valid subpath export in Zod's package. Zod (up to version 4.1.13) exports zod (main), zod/mini, and zod/locales/*, but not zod/v4. This import will likely cause a "Module not found" error at runtime.

The standard import should be import { z } from 'zod' for the main Zod API. If version 4-specific APIs are needed, they are available through the standard zod import when using Zod 4.x.

Suggested change

import { z } from 'zod/v4';

import { z } from 'zod';

src/feedback.ts

Copilot · 2026-01-05T16:41:34Z

examples/tanstack-ai-integration.ts

 import { chat } from '@tanstack/ai';
 import { openai } from '@tanstack/ai-openai';
-import { z } from 'zod';
+import { z } from 'zod/v4';


The import path zod/v4 does not appear to be a valid subpath export in Zod's package. Zod (up to version 4.1.13) exports zod (main), zod/mini, and zod/locales/*, but not zod/v4. This import will likely cause a "Module not found" error at runtime.

The standard import should be import { z } from 'zod' for the main Zod API. If version 4-specific APIs are needed, they are available through the standard zod import when using Zod 4.x.

Suggested change

import { z } from 'zod/v4';

import { z } from 'zod';

Copilot · 2026-01-05T16:41:34Z

examples/claude-agent-sdk-integration.ts

 import process from 'node:process';
 import { query, tool, createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
+import { z } from 'zod/v4';


The import path zod/v4 does not appear to be a valid subpath export in Zod's package. Zod (up to version 4.1.13) exports zod (main), zod/mini, and zod/locales/*, but not zod/v4. This import will likely cause a "Module not found" error at runtime.

The standard import should be import { z } from 'zod' for the main Zod API. If version 4-specific APIs are needed, they are available through the standard zod import when using Zod 4.x.

Suggested change

import { z } from 'zod/v4';

import { z } from 'zod';

- Move zod from dependencies to peerDependencies (>=3.25.0 <5) - Use zod/v4-mini subpath for smaller bundle size in schema/headers - Use zod/v4 subpath in feedback.ts (requires .transform/.refine) - Add zod to devDependencies and examples for development/testing This allows users to bring their own zod version (3.25+ or 4.x) while ensuring compatibility with AI SDK's zod peer dependency. The v4-mini variant reduces bundle size for simple schemas.

Copilot AI review requested due to automatic review settings January 5, 2026 16:38

ryoppippi requested a review from a team as a code owner January 5, 2026 16:38

Copilot started reviewing on behalf of ryoppippi January 5, 2026 16:38 View session

cubic-dev-ai bot reviewed Jan 5, 2026

View reviewed changes

Copilot AI reviewed Jan 5, 2026

View reviewed changes

ryoppippi force-pushed the refactor/zod-peer-dependency branch from 0560439 to e2e883f Compare January 5, 2026 16:47

ryoppippi changed the title ~~refactor(deps): move zod to peerDependencies with zod/v4 subpath import~~ refactor(deps): move zod to peerDependencies with v4-mini Jan 5, 2026

ryoppippi force-pushed the refactor/zod-peer-dependency branch from e2e883f to 11108bc Compare January 5, 2026 16:52

ryoppippi merged commit 6492f57 into main Jan 5, 2026
15 checks passed

ryoppippi deleted the refactor/zod-peer-dependency branch January 5, 2026 18:01

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

refactor(deps): move zod to peerDependencies with v4-mini#278

refactor(deps): move zod to peerDependencies with v4-mini#278
ryoppippi merged 1 commit intomainfrom
refactor/zod-peer-dependency

ryoppippi commented Jan 5, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Jan 5, 2026 •

edited

Loading

Uh oh!

cubic-dev-ai bot left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 5, 2026

Uh oh!

Copilot AI Jan 5, 2026

Uh oh!

Copilot AI Jan 5, 2026

Uh oh!

Uh oh!

Copilot AI Jan 5, 2026

Uh oh!

Copilot AI Jan 5, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		@@ -1,4 +1,4 @@
		import { z } from 'zod/mini';
		import { z } from 'zod/v4';

Conversation

ryoppippi commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Why

Test plan

Uh oh!

pkg-pr-new bot commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ryoppippi commented Jan 5, 2026 •

edited

Loading

pkg-pr-new bot commented Jan 5, 2026 •

edited

Loading